package com.gengzp.system.mapper;

import com.gengzp.common.model.permission.entity.UserRoleRelation;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * @ClassName UserRoleRelationMapper
 * @Description 用户角色关联关系Mapper层接口
 * @Author gengzp
 * @Date 2025/9/19 10:32
 */
public interface UserRoleRelationMapper {

    /**
     * 批量插入用户角色关联关系
     *
     * @param userRoleRelations 用户角色关联关系集合
     */
    void batchInsertUserRoleRelations(List<UserRoleRelation> userRoleRelations);

    /**
     * 根据角色id删除用户角色关联
     * <p> 该方法会直接物理删除 </p>
     *
     * @param roleId 角色id
     */
    void deleteUserRoleRelationsByRoleId(@Param("roleId") Long roleId);

    /**
     * 根据用户id删除用户角色关联关系
     * <p> 该方法会直接物理删除 </p>
     *
     * @param userId 用户id
     */
    void deleteUserRoleRelationsByUserId(@Param("userId") Long userId);

    /**
     * 根据用户id和角色id集合删除用户角色关联关系
     * <p> 该方法会直接物理删除 </p>
     *
     * @param userId  用户id
     * @param roleIds 角色id集合
     */
    void deleteUserRoleRelationsByUserIdAndRoleIds(@Param("userId") Long userId,
                                                   @Param("roleIds") List<Long> roleIds);

    /**
     * 根据用户id查询关联的所有角色id集合
     *
     * @param userId 用户id
     * @return 角色id集合
     */
    List<Long> selectRoleIdsByUserId(@Param("userId") Long userId);

    /**
     * 根据角色id查询关联的所有用户id集合
     *
     * @param roleId 角色id
     * @return 用户id集合
     */
    List<Long> selectUserIdsByRoleId(Long roleId);

    /**
     * 根据角色id集合查询关联的用户角色关联关系
     *
     * @param roleIds 角色id集合
     * @return 用户角色关联关系集合
     */
    List<UserRoleRelation> selectUserRoleRelationsByRoleIds(@Param("roleIds") List<Long> roleIds);

}
